home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 2 / BBS in a box - Trilogy II.iso / Files / Hyper / D / DialogDisplay 1.5 / DialogDisplay 1.5 Notes next >
Encoding:
Text File  |  1993-07-17  |  3.5 KB  |  94 lines  |  [ttro/ttxt]
  1.  
  2. DialogDisplay XFCN for HyperCard
  3. ------------------------------
  4. VERSION 1.5 - July 1993
  5. ------------------------------
  6. Version 1.5 of DialogDisplay adds several new features which were needed to
  7. evolve this XFCN into a more useful tool.  I also crushed a couple of bugs
  8. which existed in 1.0 (see bugs below).
  9.  
  10. DialogDisplay can now receive feedback from 1 to 3 buttons, and can display
  11. up to 4 strings of text.  You first must set up your dialog (DLOG) resource in
  12. ResEdit.  Each item in a dialog has an item number.  Item numbers 1-3 are
  13. reserved in DialogDisplay for buttons only. 
  14.  
  15. ------------------------------------------------------------------------
  16. SYNTAX BREAKDOWN:
  17.  
  18.    DialogDisplay (rsrcId, button1, button2, button3, text1, text2,
  19.                  text3, text4, outline)
  20.  
  21. rsrcId = The resource ID of the dialog window to be displayed.
  22. button1 = The name for button 1 (Dialog Item 1)
  23. button2 = The name for button 2 (Dialog Item 2)
  24. button3 = The name for button 3 (Dialog Item 3)
  25. text1 - text4 = The text to be displayed in a static text item using
  26.                 ^# for each item in the DLOG resource, where # is a 
  27.                 number starting at 0 up to 3.
  28. outline - Pass a 1 or 0 depending on whether or not you want to 
  29.           outline the first button (Dialog Item 1).
  30. -------------------------------------------------------------------------
  31.  
  32. You can leave parameters blank if you like.  For example, you may only have one
  33. button and one text string.  In this case, your script would look like the following:
  34.  
  35. on mouseUp
  36.    put DialogDisplay(1000,"OK",,,"Welcome!",,,,1) into buttonResult
  37. end mouseUp
  38.  
  39. The XFCN will return the number of the button pressed.
  40. So, if you have a dialog with three buttons, and one string
  41. of text, here is what you might do to handle the returning information:
  42.  
  43. on mouseUp
  44.    put DialogDisplay(1000,"Yes","No","Cancel","Want to quit?",,,,1) into buttonResult
  45.    if buttonResult = "1" then
  46.       ... handle button one stuff
  47.    else if buttonResult = "2" then
  48.       ... handle button two stuff
  49.    else if buttonResult = "3" then
  50.       ... handle button three stuff
  51.    end if
  52. end mouseUp
  53.  
  54. See the scripts for each of the Example buttons in the stack for more
  55. complete information on how to use DialogDisplay in your own stacks.
  56.  
  57. -------------------------------------------------------------------------
  58. BUG FIXES - 1.0->1.5
  59.  
  60. 1. Fixed a bug which would cause a major crash if the user specified a 1 for
  61. the outline parameter and dialog item 1 was not a button.  The software now
  62. checks to see what the item is before modifying or outlining it.
  63.  
  64. 2. Added a clean up routine to remove handles and resources when done.  This was
  65. causing some memory problems in 1.0.
  66.  
  67. 3. Fixed a problem which would cause the program to crash HyperCard if the
  68. dialog was not set to be initially visible (via ResEdit).  Dialogs which are not
  69. visible will be made visible by the software.
  70.  
  71. 4. Added code to allow the user to outline ICON/cicn dialog items.
  72.  
  73. -------------------------------------------------------------------------
  74.  
  75. DialogDisplay is SHAREWARE.  If you intend to use this XFCN in any of your own
  76. shareware, public domain, or commercial stacks please send $15 to the address
  77. below.  You will receive a license for UNLIMITED use in any number of stacks you 
  78. create.
  79.  
  80. Send your check or money order to:
  81.  
  82. Software Perspectives
  83. 3084 Peachtree Court
  84. Lake Ridge, Virginia 22192-1518
  85.  
  86. Registered users get FREE updates for as long as you own the software.  Free 
  87. techical support is also available on America Online or AppleLink.
  88.  
  89. America Online E-Mail: SPerspect
  90. AppleLink: KHarris
  91.  
  92.  
  93.  
  94.